GetIconRefOwners

GetIconRefOwners
Header:	Icons.h		Carbon status:	Supported

Provides the current reference count for an IconRef.

OSErr GetIconRefOwners (
    IconRef theIconRef, 
    UInt16 *owners
);

theIconRef: An IconRef whose reference count you wish to obtain.
owners: On return, a pointer to the value which represents the current reference count.

function result: A result code.

DISCUSSION

When an IconRef’s reference count reaches 0, all memory allocated for the IconRef is marked as disposable. Any subsequent attempt to use the IconRef returns a result code of -2580 (invalidIconRefErr).

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when IconServicesLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by IconServicesLib 8.5 and later.